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Preface 


Intended Audience 

This manual is intended for all users of VAX/VMS. 


Structure of This Document 

This manual begins with introductory information on using the Phone Utility, 
including the format of the DCL command to invoke the utility and a list 
of the commands you can enter within the utility. The rest of the manual 
presents detailed reference information and examples for each of the DCL 
command qualifiers and Phone Utility commands. 


Associated Documents 

You may also wish to become familiar with the Mail Utility, described in the 
VAX/VMS Mail Utility Reference Manual. The Mail Utility also allows you to 
communicate with other users, but it does not require the other user to be at 
his or her terminal when you initiate the communication, nor does it force the 
other user to interrupt what he or she is doing to respond. 


Conventions Used in This Document 


Convention 

iHfj 


ICTRL/x| 


$ SHOW TIME 
05-JUN-1985 11:55:22 

$ TYPE MYFILE.DAT 


Meaning 

A symbol with a one- to three-character 
abbreviation indicates that yo u pr ess a key 
on the terminal, for example, I RET | . 

The phrase CTRL/x indicates that you must press 
the key labeled CTRL while you simultaneously 
press another key, for example, CTRL/C, 
CTRL/Y, CTRL/O. 

Command examples show all output lines or 
prompting characters that the system prints 
or displays in black letters. All user-entered 
commands are shown in red letters. 

Vertical series of periods, or ellipsis, mean either 
that not all the data that the system would 
display in response to the particular command is 
shown or that not all the data a user would enter 
is shown. 
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Preface 



Convention 

Meaning 

file-spec,... 

Horizontal ellipsis indicates that additional 
parameters, values, or information can be 
entered. 

[logical-name] 

Square brackets indicate that the enclosed item 
is optional. (Square brackets are not, however, 
optional in the syntax of a directory name in a 
file specification or in the syntax of a substring 
specification in an assignment statement.) 

quotation marks 
apostrophes 

The term quotation marks is used to refer to 
double quotation marks ("). The term apostrophe 
(') is used to refer to a single quotation mark. 
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New and Changed Features 


There are no new or changed features. The Phone Utility for VAX/VMS 
Version 4.0 is essentially the same as it was for Version 3.0. 
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PHONE 


PHONE 


FORMAT 


usage summary 


The VAX/VMS Phone Utility (PHONE) allows you to communicate 
with other users on your system or with any other VAX system 
connected to your system by DECnet-VAX. PHONE is designed to 
simulate some of the features of real telephone communications, 
such as the hold button, conference calls, and telephone directories. 


PHONE 


Command Qualifiers Defaults 

/[NOJSCROLL /SCROLL 

/S WITCH—HOOK= "character " /SWITCH-HOOK=% 

/VIEWPORT—SIZE=n See text. 

Command Parameters 

None. 


Invoking 

To invoke PHONE, enter the following DCL command in response to the 
DCL command level prompt. 

PHONE[/qualifier(s)] [phone-command] 

When PHONE is invoked, it formats the entire screen as shown in 
Figure PHONE-1. 

Exiting 

To exit from PHONE, issue the EXIT command. When you enter this 
command, PHONE returns you to the DCL command level. If you are in 
the Phone Utility but are not currently engaged in a conversation, you can 
press CTRL/Z to exit from PHONE. 

The HANGUP command is used to hang up your own phone. It disconnects 
all current links, but leaves you in the Phone Utility. Pressing CTRL/Z 
during a conversation is equivalent to issuing the HANGUP command. 

Privileges/Restrictions 

PHONE can be used only on video terminals with direct cursor positioning, 
such as the DIGITAL VT52, VT100, and VT200 series terminals. The Phone 
Utility uses the SCOPE terminal characteristic to determine if it can support a 
terminal. 
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PHONE 

Description 


commands 


DESCRIPTION 


Figure PHONE-1 PHONE Format 


r 


% 


VAX/VMS Phone facility 
(command input line) 


- \ 

11 -SEP-1984 


TAURUS::SMITH 


GEMINI::PETERS 


V_/ 

Note: The switch hook character is always displayed in column 1 
of the command input line. 

ZK-898-82 


Syntax 

%command [parameter] 


PHONE Commands 

ANSWER 

DIAL 

DIRECTORY 

EXIT 

FACSIMILE 

HANGUP 

HELP 

HOLD 

MAIL 

PHONE 

REJECT 

UNHOLD 


When you invoke the Phone Utility, PHONE takes control of your terminal 
and displays the PHONE screen layout. 
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PHONE 

Description 


Screen Layout 

Each person engaged in the conversation has a viewport on the screen. 
PHONE can display as many as six viewports at a time. 

The viewport contains information regarding the user: the person's name, 
the text of his/her conversation, and various status indicators. The indicators 
include information such as who is on hold. People you have on hold can be 
temporarily eliminated from the screen to make room for new participants. 


Conversation Text 

When you are engaged in a conversation, most of the characters that you type 
are considered part of that conversation and are sent to each participant. The 
exception is the switch-hook character, which signals that you want to enter 
a Phone Utility command. (You can enter any Phone Utility command in the 
midst of a conversation.) 

All normal ASCII text characters are displayed in the viewport. Some ASCII 
control characters can be used for formatting (see the following list); other 
control characters are ignored. 


Control Key 

Formatting Function 

DELETE 

Deletes the previous character 

LINE FEED 

Deletes the previous word 

RETURN 

Starts a new line in the viewport 

TAB 

Advances to the next tab stop 

CTRL/G 

Sounds the buzzer at both your terminal and the terminal of 
anyone linked to the current PHONE conversation 

CTRL/L 

Clears all text in the viewport 

CTRL/Q 

Allows normal receiving of characters. CTRL/Q also negates 
a CTRL/S 

CTRL/S 

Freezes the characters currently on screen 

CTRL/U 

Clears the current viewport line 

CTRL/W 

Refreshes the entire screen 

CTRL/Z 

Equivalent to the HANGUP command if used during a 
conversation; equivalent to the EXIT command if used when 
no conversation is in progress 


Conference Calls 

When setting up a conference call, one participant acts as the operator. The 
operator establishes the conference by calling the other participants in turn 
and waiting for an answer. 

Only users currently participating in the conference call can bring in new 
participants with the DIAL or PHONE command. If you dial a person 
already participating in an ongoing conference call, you will talk only to the 
participant you called. 
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PHONE 

Command Qualifiers 


COMMAND 

QUALIFIERS 


When specifying the DCL command PHONE, you can supply qualifiers that 
modify the characteristics of the simulated telephone. The PHONE command 
qualifiers are presented alphabetically in this section. 
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PHONE 

/SCROLL 


/SCROLL 

Determines how new lines of text are displayed on the screen when 
the viewport becomes full. If /NOSCROLL is specified, the text lines 
are wrapped and new text appears on the top line of the viewport. 
Specifying /NOSCROLL improves the response time for terminals 
operating at slow speeds. 

If /SCROLL is specified, the text is scrolled up one line each time a 
new line of text is entered. The new line appears at the bottom of 
the viewport. /SCROLL is the default. 

FORMAT 

/[NOJSCROLL 

qualifier values 

None. 
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PHONE 

/SWITCH_HOOK 


/SWITCH 


FORMAT 

qualifier value 


HOOK 


Specifies the PHONE switch-hook character. The switch-hook 
character must be entered before each Phone Utility command that 
is issued during a conversation. PHONE commands are terminated 
by pressing RETURN or by entering the switch-hook character. Text 
typed without the switch-hook character is considered part of the 
conversation. 


/SWITCH_HOOK= "character" 


"character" 

You can use any nonalphanumeric character as the switch-hook character. 
Enclose the character in quotation marks. The default switch-hook character 
is the percent sign. 
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PHONE 

/VIEWPORT_SIZE 


/VIEWPORT-SIZE 

Specifies the maximum number of lines in a viewport, including the 



heading line and the bottom line of dashes. Smaller viewports will 
improve the response time on terminals operating at slow speeds. 

FORMAT 

/VIEWPORT_SIZE=n 

qualifier value 

n 

This parameter specifies the size of the viewport. The valid range is 3 to 

10. If there are two participants in the conversation, the default viewport 
size is 10. PHONE automatically reduces the default viewport size as more 
participants enter the conversation. 
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PHONE 

Commands 


COMMANDS 


To enter PHONE commands, you must first press the switch-hook character. 
Some commands also require that you enter additional information after the 
keyword. PHONE commands can be abbreviated. 

If you are using the Phone Utility but are not currently engaged in a 
conversation, the switch-hook character is optional because there is no 
ambiguity between a command and conversation. 

You can press CTRL/W at any time during your current conversation to 
refresh the screen. 

The DIAL, DIRECTORY, MAIL, and PHONE commands accept logical names. 
If you want to prevent PHONE from treating a parameter to these commands 
as a logical name, prefix the parameter with an underscore. 

You cannot use node numbers to access someone on another node, but 
multiple node names (for example, NODEl::NODElA::JONES) are acceptable. 
DECnet access strings are also acceptable. 

The PHONE commands in this section are presented alphabetically, with 
each command description beginning on a new page. 
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PHONE 

ANSWER 


ANSWER 

Answers the phone when you receive a call. If the call comes when 
you are not currently in the Phone Utility, a message is broadcast 
to your terminal. If you are currently using PHONE, the message 
appears in PHONE’s standard message line, which is located under 
the command input line on your screen (see Figure PHONE-1). 

FORMAT 

ANSWER 

command 

parameters 

command 

qualifiers 

None. 

None. 

EXAMPLE 


'/►ANSWER 

The ANSWER command establishes a link with the caller. 
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PHONE 

DIAL 


DIAL 

Places a call to another user. You must include the user name of 
the person to whom you are placing the call. The user name must 
be preceded by a DECnet-VAX node name if the person is on 
another node. A logical name can be substituted for the user-name 
parameter. 

When you issue the DIAL command, PHONE broadcasts a message 
to the user's terminal to indicate that you are calling. This message 
will flash every 10 seconds until one of the following happens: 

• The user answers the phone. 

• The user rejects the call. 

• You press any key on the keyboard. This action cancels the call. 

If you enter a user name without a specific command, the DIAL 
command is assumed. 

FORMAT 

DIAL [ node::]user-name 

command 

parameters 

[node::]user-name 

Specifies the name of the user to be phoned and the node, if it is not the 
same as your current node. Node numbers cannot be entered when you are 
calling someone on another node. DECnet access strings and multiple nodes 
are allowed. 

command 

qualifiers 

None. 

EXAMPLE 


•/.DIAL TAURUS: :SMITH 

The DIAL command places a call to Smith on node TAURUS. 
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PHONE 

DIRECTORY 


DIRECTORY 



Lists those users with whom you can talk on your system or any 
other system in the network. If you enter the DIRECTORY command 
without additional information, PHONE lists the users on your 
system. If you enter the DIRECTORY command with a node name, 
PHONE lists the users on that system. You can substitute a logical 
name for the node name in the command line. 

The directory is displayed on your screen, line by line, until the entire 
list has been typed or until you press any key on the keyboard. The 
following information is shown for each user: 

• Process name 

• User name 

• Terminal device name 

• Phone status 

FORMAT 

DIRECTORY [node[::]] 

command 

parameters 

node[::] 

When a node name is specified, PHONE lists the users on that system. The 
colons are optional. 

command 

qualifiers 

None. 

EXAMPLE 


•/.DIRECTORY TAURUS 

The DIRECTORY command lists all the users currently working on node 
TAURUS. 
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PHONE 

EXIT 


EXIT 

Exits from the Phone Utility. When you enter this command, PHONE 
automatically executes the HANGUP command and returns you to 
the DCL command level. 

Pressing CTRL/Z when there is no conversation is equivalent to 
issuing the EXIT command. (Pressing CTRL/Z during a conversation 
is equivalent to issuing the HANGUP command.) 

FORMAT 

EXIT 

command 

parameters 

command 

qualifiers 

None. 

None. 

EXAMPLE 


•/.DIAL PETERS 


•/.HANGUP 
•/.DIAL FENTON 


•/.EXIT 

$ 

This example illustrates the difference between the two PHONE commands 
HANGUP and EXIT. At the first PHONE prompt, Peters is dialed. The phone 
connection to Peters is terminated with the HANGUP command, but the user 
is still in the Phone Utility. The phone connection to Fenton is terminated 
with the EXIT command, which also causes an exit from PHONE and a return 
to DCL command level. (Note that CTRL/Z could have been used instead of 
the HANGUP command.) 
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PHONE 

FACSIMILE 


FACSIMILE 


Allows you to include the contents of a file in your conversation. It 
sends the contents of the specified file to the current participant(s) 
in the call. 

PHONE continues to send the file until it reaches the end of the file 
or until you press any key on the keyboard, at which point PHONE 
stops sending the file. 


FORMAT 

FACSIMILE 

file-spec 

command 

file-spec 


parameters 

Specifies the name 

of the file to be included. 

command 

None. 


qualifiers 




EXAMPLE 


•/.FACSIMILE WORK. DAT 

The FACSIMILE command specifies that the contents of the file WORK.DAT 
be included in your current phone conversation. 
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PHONE 

HANGUP 


HANGUP 

Hangs up your phone. This disconnects all current links—the 
current conversation, anyone you have on hold, and anyone who 
has you on hold. The HANGUP command does not cause an exit 
from the Phone Utility. 

Pressing CTRL/Z during a conversation is equivalent to issuing 
the HANGUP command. (Pressing CTRL/Z when there is no 
conversation is equivalent to issuing the EXIT command.) 

FORMAT 

HANGUP 

command 

parameters 

None. 

command 

qualifiers 

None. 

EXAMPLE 


•/.DIAL PETERS 


•/, HANGUP 
•/.DIAL FENTON 


•/.EXIT 

$ 

This example illustrates the difference between the two PHONE commands 
HANGUP and EXIT. At the first PHONE prompt, Peters is dialed. The phone 
connection to Peters is terminated with the HANGUP command, but the user 
is still in the Phone Utility. The phone connection to Fenton is terminated 
with the EXIT command, which also causes an exit from PHONE and a return 
to DCL command level. (Note that CTRL/Z could have been used instead of 
the HANGUP command.) 
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PHOIME 

HELP 


HELP 

Enables you to obtain information about the Phone Utility. To obtain 
general PHONE information, type HELP. 

To obtain specific information about individual PHONE commands 
or topics, type HELP followed by the command or topic name, for 
example HELP DIAL. 

The information you request is displayed on your screen until all 
information on the selected topic has been displayed or until you 
press any key on the keyboard. (Pressing any key causes an exit 
from the Phone Utility HELP.) 

FORMAT 

HELP [topic] 

command 

parameters 

topic 

Denotes a specific topic on which to supply information. 

command 

qualifiers 

None. 

EXAMPLE 


•/.HELP DIAL 

The HELP command supplies you with information on the DIAL command. 
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PHONE 

HOLD 


HOLD 

Enables you to put other users, who are currently participating 
in a conversation with you, on hold. When you enter the HOLD 
command, everyone who is currently on the phone with you 
(including anyone who has you on hold) is placed on hold. A 
message is sent to each terminal indicating that the user has been 
placed on hold. 

PHONE allows you to make calls to other users while you have 
someone on hold. 

FORMAT 

HOLD 

command 

parameters 

None. 

command 

qualifiers 

None. 

EXAMPLE 


•/.HOLD 

The HOLD command puts anyone with whom you are having a current 
PHONE conversation on hold. 
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PHONE 

MAIL 

MAIL 

Allows you to send a short message to another person. For 
example, when you call someone who is not in, you can leave a 
message to call you back. 

The MAIL command requires two parameters: the user name of 
the person to whom the message is to be sent, and the message, 
which must be enclosed in quotation marks. A logical name can be 
substituted for the user-name parameter. 

FORMAT 

MAIL [ node::]user-name "shortmessage" 

command 

[inode::Juser-name 

parameters 

Specifies the name of the user to receive the mail. Include the node when the 
person you want to receive the message is not on your current node. 

"short message " 

Denotes the contents of the message to be sent. The message must be 
enclosed in quotation marks and cannot exceed a single line. 

command 

qualifiers 

None. 


EXAMPLE 


‘/.MAIL TAURUS: :SMITH "THE MEETING IS AT ELEVEN." 

The MAIL command sends the message to Smith on node Taurus. 
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PHONE 

PHONE 


PHONE 


Is synonymous with the DIAL command. The two commands can 
be used interchangeably. 
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PHONE 

REJECT 


REJECT 

Allows you to reject a call from another user while you are using 
PHONE. A message indicating that the call has not been accepted is 
displayed on the caller's screen. 

The REJECT command accepts the optional parameter EXIT. If 
this parameter is specified, PHONE performs an EXIT command 
following the rejection. This feature allows you to set up a 
personalized VAX/VMS command that can reject a call and return 
to DCL without your intervention. Such a personalized command 
might appear in your login command file as shown below: 

$ REJECT :== "PHONE REJECT EXIT" 

FORMAT 

REJECT [EXIT] 

command 

parameters 

EXIT 

Enables you to reject a call and exit from PHONE with one command. 

command 

qualifiers 

None. 

EXAMPLE 


•/.REJECT 

The REJECT command rejects a phone call from another user, but does not 
cause an exit from the Phone Utility. 


PHONE-19 









PHONE 

UNHOLD 


UNHOLD 

Reverses the most recently issued HOLD command. A user who 
was placed on hold by the previous HOLD command is removed 
from hold. A user who was placed on hold before the most recent 
HOLD command remains on hold. 

FORMAT 

UNHOLD 

command 

parameters 

None. 

command 

qualifiers 

None. 

EXAMPLE 


•/UNHOLD 

The UNHOLD command reverses the last HOLD command that was issued. 
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